Release 10.1A: OpenEdge Getting Started:
Installation and Configuration


Mergeprop

Provides a consistent means to manage and maintain the content of property files, by direct user action or programmatically. Property files store configuration information that identify and control the behavior of various components. The mergeprop program is located in the OpenEdge-Install-Directory\bin.

Presented through a command-line interface, the mergeprop utility is an alternative, fully supported tool by which you can update a property file when either the Progress Explorer tool is not available or you choose to use this approach.

The following table presents the mergeprop syntax.

Operating system
Syntax
UNIX
Windows
mergeprop -type file_type 
           [-action operation_type [group_name]] 
           [-target target_file]  
           [-delta delta_file] 
           [-validate] 
           [-nobackup] 
           [-silent] 
           [-recurse] 

Reference Table C–1 for the details about valid values for argument variables.

All of the command switches identified in the previous syntax and presented in more detail in Table C–1 can occur in any sequence following the mergeprop command.

Command switches and arguments

Table C–1 summarizes the syntax elements used with the mergeprop command. Refer to the preceding section and the "Mergeprop utility overview" section for additional descriptive information.

Table C–1: Command line input to the mergeprop command
Switch
Arguments
Notes
-type
(required) 
ubroker 
database 
tools 
plugin 
none 
Each argument (other than none) implies a specific target file in the properties directory.
See the “File Type” section in Chapter 10 "Configuration Basics".
-action1 
update 
create 
delete 
list group_name 
listall group_name 
If no action is specified, update is assumed by default.
The list and listall actions require an additional argument, the name of the property group to be displayed (for example, ubroker.AS.asbroker1). Do not include the square brackets ([]) that enclose the group name in the ubroker.properties file.
On update and create actions, groups listed with no properties in the delta file are ignored.
-target 
(optional) 
Path to the property file to be modified.
If you are updating a property file that is in the <OpenEdge-Install-Dir>/properties subdirectory, you can omit this option. Only use this option when the property file you plan to update exists in a location other than the <OpenEdge-Install-Dir>/properties subdirectory.
-delta 
Path to the delta 
file containing 
changes to be made 
File containing create, update, or delete changes.
-validate 
None.
Performs all processing without actually making changes to the target file. This option lets you test for errors.
-nobackup 
None.
Does not create a backup to the target file before making changes. Unless you invoke this option, mergeprop saves a copy of the original target file in the same directory. The backup copy has a system- generated unique string appended to the name (for example, ubroker.properties (31420040644533).
-silent 
None.
Suppresses all messages.
-recurse 
None.
Lists or deletes all groups, server groups, and configurations associated with the specified database.
1Command switches can occur in any order following the mergeprop command.


Copyright © 2005 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095